home *** CD-ROM | disk | FTP | other *** search
/ The Business Master (3rd Edition) / The Business Master (3rd Edition).iso / files / utilstem / util2 / utils.doc < prev    next >
Encoding:
Text File  |  1987-10-01  |  10.0 KB  |  295 lines
  1.  
  2.  
  3.          NICKL Utilities Version 1.0 - Companion to NICKL Menu System
  4.  
  5.                        Copyright (C) 1987 by C.K. Ingram
  6.  
  7.  
  8.  
  9. The  NICKL  Utilities program provides several useful batch file utilities all
  10. wrapped up in one neat little package. Follow is the proper  usage  syntax  to
  11. UTILS:
  12.  
  13.       Usage: UTILS <Subprogram>
  14.       Where Subprogram is one of the following:
  15.  
  16.         ASK [Color] [Prompt]
  17.         NUM [Color] [Prompt]
  18.         ALPH <Accepted Letters> [Color] [Prompt]
  19.         FKEY [Color] [Prompt]
  20.         WAIT <Seconds> [Color] [Prompt]
  21.         TIMER <Seconds> [Color] [Prompt]
  22.         TIMEASK [Color] [Prompt]
  23.         COLOR <Color> <Prompt>
  24.         CENTER [Color] <Prompt>
  25.         XY <Column> <Row> [Color] [Prompt]
  26.         SINGLE [Color]
  27.         DOUBLE [Color]
  28.         SKIP <# of Lines to Skip>
  29.  
  30.       <> These items are Required.     [] These items are Optional.
  31.  
  32.       NOTE: For color, numbers 16-31 produce blinking text.
  33.  
  34.  
  35. Do for a brief description of each integrated utility:
  36.  
  37. ================================================================================
  38.  
  39. ASK [Color] [Prompt]   Asks for a Y or N response.
  40.  
  41.    ASK  will  stop  the  batch  file  and  prompt you for a response. The only
  42.    acceptable response is either a Y for Yes or a N for N.
  43.    Example:
  44.        Command       UTILS ASK
  45.        Returns       (Y or N):
  46.  
  47.        Command       UTILS ASK Do you wish to continue?
  48.        Returns       Do you wish to continue?
  49.  
  50.        Command       UTILS ASK 6 Do you wish to start?
  51.        Returns       Do you wish to start?             in brown text
  52.  
  53. Errorlevel returned:
  54.    N = errorlevel 2
  55.    Y = errorlevel 1
  56.  
  57. ================================================================================
  58.  
  59. NUM [Color] [Prompt]  Asks for a response of 1 - 9.
  60.  
  61.    ASK will stop the batch file and  prompt  you  for  a  response.  The  only
  62.    acceptable response is a number of 1 through 9.
  63.    Example:
  64.        Command       UTILS NUM
  65.        Returns       Enter desired Number (1-9):
  66.  
  67.        Command       UTILS NUM Select a Number:
  68.        Returns       Select a Number:
  69.  
  70.        Command       UTILS NUM 2 Select a Number:
  71.        Returns       Select a Number:              in green text
  72.  
  73. Errorlevel returned:
  74.    9 = errorlevel 9       8 = errorlevel 8       7 = errorlevel 7
  75.    6 = errorlevel 6       5 = errorlevel 5       4 = errorlevel 4
  76.    3 = errorlevel 3       2 = errorlevel 2       1 = errorlevel 1
  77.  
  78. ================================================================================
  79.  
  80. ALPH <Accepted Letters> [Color] [Prompt]  Asks for a response of A - Z.
  81.  
  82.    ALPH  will  stop  the  batch  file  and prompt you for a response. The only
  83.    acceptable response is a letter of A through Z. You must tell  UTILS  which
  84.    letters are to be used though.
  85.    Example:
  86.        Command       UTILS ALPH ABC
  87.        Returns       Enter desired Letter:    only A or B or C will be accepted.
  88.  
  89.        Command       UTILS ALPH ABC Make your selection:
  90.        Returns       Make your selection:
  91.  
  92.        Command       UTILS ALPH ABC 1 Make your selection:
  93.        Returns       Make your selection:            in blue text
  94.  
  95. Errorlevel returned:
  96.    A = errorlevel 1
  97.    B = errorlevel 2
  98.    C = errorlevel 3
  99.    .
  100.    .
  101.    Y = errorlevel 25
  102.    Z = errorlevel 26
  103.  
  104. ================================================================================
  105.  
  106. FKEY [Color] [Prompt]      Asks for a response of F1 - F10.
  107.  
  108.    FKEY  will  stop  the  batch  file  and prompt you for a response. The only
  109.    acceptable response is a Function Key.
  110.    Example:
  111.        Command       UTILS FKEY
  112.        Returns       Press desired Function key:
  113.  
  114.        Command       UTILS FKEY Hit any old Function Key:
  115.        Returns       Hit any old Function Key:
  116.  
  117.        Command       UTILS FKEY 13 Hit any old Function Key:
  118.        Returns       Hit any old Function Key:         in light magenta text
  119.  
  120. Errorlevel returned:
  121.    F1 = errorlevel 1
  122.    F2 = errorlevel 2
  123.    F3 = errorlevel 3
  124.    F4 = errorlevel 4
  125.    F5 = errorlevel 5
  126.    F6 = errorlevel 6
  127.    F7 = errorlevel 7
  128.    F8 = errorlevel 8
  129.    F9 = errorlevel 9
  130.    F0 = errorlevel 10
  131.  
  132. ================================================================================
  133.  
  134. WAIT <Seconds> [Color] [Prompt]
  135.  
  136.    WAIT delays execution of the batch file by X number of seconds.
  137.    Example:
  138.        Command       UTILS WAIT 5
  139.        Returns       ***Nothing***     But a delay of 5 seconds occurs.
  140.  
  141.        Command       UTILS WAIT 3 Waiting....Waiting....Waiting....
  142.        Returns       Waiting....Waiting....Waiting....    with a 3 second delay
  143.  
  144.        Command       UTILS WAIT 3 4 Waiting....Waiting....Waiting....
  145.        Returns       Waiting....Waiting....Waiting....         in red text
  146.  
  147. ================================================================================
  148.  
  149. TIMER <Seconds> [Color] [Prompt]
  150.  
  151.    TIMER is similar to WAIT except a counter is displayed after to prompt.
  152.  
  153. ================================================================================
  154.  
  155. TIMEASK [Color] [Prompt]
  156.  
  157.    TIMEASK is similar tp ASK except that you only have four  seconds  to  give
  158.    your response or else an errorlevel of 0 is returned.
  159.  
  160. ================================================================================
  161.  
  162. COLOR <Color> <Prompt>
  163.  
  164.    COLOR is similar to the DOS echo command only you can tell it what color to
  165.    display the prompt in.
  166.  
  167. ================================================================================
  168.  
  169. CENTER [Color] <Prompt>
  170.  
  171.    CENTER is just like COLOR except that the prompt is centered on the line.
  172.  
  173. ================================================================================
  174.  
  175. XY <Column> <Row> [Color] [Prompt]
  176.  
  177.    XY  is  similar  to  COLOR  except that you tell UTILS exactly where on the
  178.    screen the place the prompt.
  179.  
  180. ================================================================================
  181.  
  182. SINGLE [Color]
  183.  
  184.    SINGLE draws a single line across you screen in the desired color.
  185.  
  186. ================================================================================
  187.  
  188. DOUBLE [Color]
  189.  
  190.    DOUBLE draws a double line across you screen in the desired color.
  191.  
  192. ================================================================================
  193.  
  194. SKIP <# of Lines to Skip>
  195.  
  196.    SKIP does just a what you think it would. If you are on line one and  enter
  197.    UTILS SKIP 15 you'll be on line 15.
  198.  
  199. ================================================================================
  200.  
  201.  
  202.  
  203. REGISTRATION
  204.  
  205. I hope to be making future  enhancements  to  NICKL  Utilities,  however,  the
  206. amount  of time and money available to me will determine how soon enhancements
  207. and releases will be made.
  208.  
  209. I  you  find  the  program  of  use  and  you end up using the program, then a
  210. contribution is requested. The suggested amount is $5.00.
  211.  
  212. Please fill out the attached registration  form  and  send  to  the  indicated
  213. address.
  214.  
  215. Your support of this program will ensure that the quality is kept to a maximum
  216. as  well  as  to  the  continuing  advancement  of shareware and public domain
  217. software in general.
  218.  
  219.  
  220. SITE LICENSE
  221.  
  222. If you are using this in a corporate environment you should consider obtaining
  223. a site license for the use of NICKL Menu System. The site license is based  on
  224. the  total  number of computers on which NICKL will be used. The fee structure
  225. is as follows:
  226.  
  227.            1 -  5 copies   $5.00 each
  228.            6 - 10 copies   $4.00 each
  229.           10+     copies  $40.00 one time fee (this provides unlimited
  230.                                  within you corporation.)
  231.  
  232. If you register for an unlimited (10+ copies)  site  license  and  would  like
  233. NICKL  Menu  customized in any way for your individual application then please
  234. state so when you register and list how you would like it customized.  I  will
  235. make  every attempt do fulfill your wish and send you your customized version.
  236. This may include, but is not limited to, having your companies name  hardcoded
  237. into  NICKL. Please provide your telephone number so that I may contact you if
  238. I have any questions.
  239.  
  240.  
  241.  
  242.  
  243. ==============================================================================
  244.                       NICKL Utilities Registration Form
  245.  Version 1.0                                                     October 1987
  246. ==============================================================================
  247.  
  248. I wish to register my copy of  NICKL  Utilities.  I  have  enclosed  my  check
  249. payable to "C.K. Ingram" for $5.00 for each copy (see Site License section for
  250. prices  in  excess  of  10).  Below  you  will find my personal 'wish list' of
  251. desired future enhancements.
  252.  
  253.      Send to:       C.K. Ingram
  254.                     21217-32 E. Washington Street
  255.                     Walnut, CA 91789
  256.  
  257. Enclosed, please find a check for $__________ to  cover  the  registration  of
  258. ______ copies of NICKL Utilities.
  259.  
  260.  
  261.      Name:   ____________________________________________________________
  262.  
  263.      Company:____________________________________________________________
  264.  
  265.      Address:____________________________________________________________
  266.  
  267.              ____________________________________________________________
  268.  
  269.      Phone #:____________________________________________________________
  270.  
  271.  
  272.  
  273.      Comments:___________________________________________________________
  274.  
  275.               ___________________________________________________________
  276.  
  277.               ___________________________________________________________
  278.  
  279.               ___________________________________________________________
  280.  
  281.               ___________________________________________________________
  282.  
  283.  
  284.  
  285.      Wish List:__________________________________________________________
  286.  
  287.                __________________________________________________________
  288.  
  289.                __________________________________________________________
  290.  
  291.                __________________________________________________________
  292.  
  293.  
  294. ==============================================================================
  295.